_m_a_p Specifies the name of the pixel map to return. Accepted values
are GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS,
GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB, and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA.
_v_a_l_u_e_s Returns the pixel map contents.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
See the ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp reference page for a description of the acceptable
values for the _m_a_p parameter. ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp returns in _v_a_l_u_e_s the
contents of the pixel map specified in _m_a_p. Pixel maps are used during
the execution of ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
and ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD to map color indices, stencil indices, color components,
and depth components to other values.
Unsigned integer values, if requested, are linearly mapped from the
internal fixed or floating-point representation such that 1.0 maps to the
largest representable integer value, and 0.0 maps to 0. Return unsigned
integer values are undefined if the map value was not in the range [0,1].
To determine the required size of _m_a_p, call ggggllllGGGGeeeetttt with the appropriate
symbolic constant.
NNNNOOOOTTTTEEEESSSS
If an error is generated, no change is made to the contents of _v_a_l_u_e_s.
EEEERRRRRRRROOOORRRRSSSS
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_a_p is not an accepted value.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp is executed between
the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.